<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
	<title>About ant-util</title>
</head>
<body>
<h3>About ant-util</h3>
<p>ant-util　project is collection of Ant utilities for stand-alone Ant environment and 
maven-antrun-plugin environment.</p>
<p><h4>Ant Tasks</h4>
This project provides the following Ant tasks. 
<ul>
	<li><b>mvnpath</b> tag : <u>extension of Ant's path tag</u><br />
		<ul>
			<li>Use case<br />
				When you like to get path to .jar file of the dependency (what is not defined in 
				the dependency section of Maven pom.xml) in Maven local repository.
			</li>
			<li>Brief example<br />
				<blockquote>
					<code>
					&lt;mvnpath&gt;<br />
					&nbsp;&nbsp;&nbsp;&nbsp;
					&lt;mvnpathelement dependency=&quot;a_group_id:an_artifact_id:1.2.3&quot; /&gt;<br />
					&lt;/mvnpath&gt;
					</code>
				</blockquote>
			</li>
		</ul>
		 For more info, refer to <a href="./apidocs/com/newmainsoftech/ant/types/maven/MavenPath.html"
		 >MavenPath class JavaDoc</a>.<br />
		 <br />
	</li>
	<li><b>mvnproperty</b> tag : <u>extension of Ant's property tag</u><br />
		<ul>
			<li>Use case<br />
				When you like to have Maven property defined at same time of defining Ant property. 
				So, you can refer such property's value in other execution of Maven plugin in 
				your project pom.xml.
			</li>
			<li>Brief example<br />
				<ul>
					<li>To define property 
						<blockquote>
							<code>
							&lt;mvnproperty<br />
							&nbsp;&nbsp;&nbsp;&nbsp;name=&quot;propName1&quot;<br />
							&nbsp;&nbsp;&nbsp;&nbsp;value=&quot;propValue1&quot; /&gt;
							</code>
						</blockquote>
					</li>
					<li>To define property for dependency path
						<blockquote>
							<code>
							&lt;mvnproperty<br />
							&nbsp;&nbsp;&nbsp;&nbsp;
							dependency=&quot;com.google.gwt:gwt-dev:2.4.0&quot; /&gt;
							</code>
						</blockquote>
						After that, you can obtain the actual path by inquiring ${com.google.gwt:gwt-dev:jar} 
						as if the com.google.gwt:gwt-dev:2.4.0 dependency had been defined in the dependency 
						section of your project's pom.xml. 
					</li>
				</ul>
			</li>
		</ul>
		For more info, refer to <a href="./apidocs/com/newmainsoftech/ant/taskdefs/maven/MavenProperty.html"
		>MavenProperty class JavaDoc</a>.<br />
		<br />
	</li>
	<li><b>mvnservercreden</b> tag: <u>extension of Ant's property tag</u><br />
		<ul>
			<li>Use case<br />
				When you like to read server credential information from <code>servers</code> 
				element of Maven global or user settings file and store user name and decrypted password 
				to properties. 
			</li>
			<li>Brief example<br />
				<blockquote><code>
				&lt;mvnservercreden serverid="test_ds1" /&gt;
				</code></blockquote>
				That mvnservercreden tag performs reading user name and password for test_ds1 server 
				element from default Maven settings file (default to ${user.home}/.m2/settings.xml and 
				${M2_HOME}/conf/settins.xml) and store user name and decrypted password to 
				test_ds1.username and test_ds1.password Maven properties (as well as Ant properties).
			</li>
		</ul>
		For more info, refer to <a href="./apidocs/com/newmainsoftech/ant/taskdefs/maven/MavenServerCredential.html"
		>MavenServerCredential class JavaDoc</a>.<br />
		<br />
	</li>
	<li><b>javaext</b> tag : <u>extension of Ant's java tag</u><br />
		<ul>
			<li>Use case<br />
				When you're reluctant to write multiple arg tags, jvmarg tags and/or sysproperty tags. 
			</li>
			<li>Brief example<br />
				<blockquote>
					<code>
					&lt;javaext classname=&quot;some.name.of.ClassToExecute&quot;&gt;<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&lt;jvmargext&gt;<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-Xmx768m -Xss4M<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
					-javaagent:${agent_path}=nbjdk=JDK6u24;profile=java;<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-Xbootclasspath:${some_path}<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&lt;/jvmargext&gt;<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&lt;argext&gt;<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
					-Dmulti-line-arg1=argext1 -Dmulti-line-arg2=argext2<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-Dmulti-line-arg3=${arg3_value}<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&lt;/argext&gt;<br />
					&nbsp;&nbsp;&nbsp;&nbsp;...<br />
					&lt;/javaext&gt;
					</code>
				</blockquote>
			</li>
		</ul>
		For more info, refer to <a href="./apidocs/com/newmainsoftech/ant/taskdefs/JavaTaskExt.html"
		>JavaTaskExt class JavaDoc</a>.<br />
		<br />
	</li>
	<li><b>junitext</b> tag : <u>extension of Ant's junit tag</u><br />
		<ul>
			<li>Use case<br />
				When you're reluctant to write multiple jvmarg tags and/or sysproperty tags.  
			</li>
			<li>Brief example<br />
				<blockquote>
					<code>
					&lt;junitext fork=&quot;yes&quot; printsummary=&quot;yes&quot; 
					showoutput=&quot;true&quot; haltonfailure=&quot;yes&quot;&gt;<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&lt;jvmargext&gt;<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-Xmx256m -Xdebug<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
					-Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=${debug_port}<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&lt;/jvmargext&gt;<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&lt;syspropext&gt;<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
					gwt.args=-standardsMode -war ${war_dir} -logLevel WARN<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;java.awt.headless=true<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
					gwt.devjar=${com.google.gwt:gwt-dev:jar}<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
					java.util.logging.config.file=test/com/gwetons/client/devMode.logging.properties<br />
					&nbsp;&nbsp;&nbsp;&nbsp;&lt;/syspropext&gt;<br />
					&nbsp;&nbsp;&nbsp;&nbsp;...<br />
					&lt;/junitext&gt;
					</code>
				</blockquote>
			</li>
		</ul>
		For more info, refer to <a href="./apidocs/com/newmainsoftech/ant/taskdefs/JUnitTaskExt.html"
		>JUnitTaskExt class JavaDoc</a>.<br />
		<br />
	</li>
</ul>
For more examples of those above tasks, you can take a look at 
<a href="https://code.google.com/p/ant-util/source/browse/trunk/ant/maven-antrun.ant.xml"
>maven-antrun.ant.xml file</a> what is actually used for integration tests via Maven for this project. 
</p>
<p><h4>Download</h4>
<ul>
	<li>For automated download as a dependency of your project via various build/dependency-management tools 
	(such as Maven), refer to <a href="https://ant-util.googlecode.com/svn/site/dependency-info.html"
	>dependency-info page</a>. 
	</li>
	<li>For manual download, download from <a href="https://oss.sonatype.org/content/groups/public/com/newmainsoftech/ant-util/"
	>ant-util artifacts link</a>.<br />
		To use this project's artifact by manually downloading, please also refer to 
		<a href="https://ant-util.googlecode.com/svn/site/dependencies.html">dependencies page</a> 
		to get the list of sub-dependencies what needs to be downloaded manually too. 
	</li>
</ul>
</p>
</body>
</html>